home *** CD-ROM | disk | FTP | other *** search
/ InterCD 2000 September / september_2000.iso / intercd / root / ^Linux / cdrtools-1.10 / doc / cdrecord.man < prev    next >
Encoding:
Text File  |  2000-04-27  |  59.0 KB  |  1,321 lines

  1.  
  2.  
  3.  
  4. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cdrecord - record audio or data Compact Discs from a master
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ccccddddrrrreeeeccccoooorrrrdddd [ _g_e_n_e_r_a_l _o_p_t_i_o_n_s ] ddddeeeevvvv====_d_e_v_i_c_e [  _t_r_a_c_k  _o_p_t_i_o_n_s  ]
  13.      _t_r_a_c_k_1..._t_r_a_c_k_n
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      CCCCddddrrrreeeeccccoooorrrrdddd is used to record data or audio Compact Discs on an
  18.      Orange Book CD-Recorder.
  19.  
  20.      The _d_e_v_i_c_e refers to _s_c_s_i_b_u_s/_t_a_r_g_e_t/_l_u_n of the  CD-Recorder.
  21.      Communication  on _S_u_n_O_S is done with the SCSI general driver
  22.      ssssccccgggg.... Other operating systems are using a library  simulation
  23.      of    this    driver.     Possible    syntax    is:     ddddeeeevvvv====
  24.      _s_c_s_i_b_u_s,_t_a_r_g_e_t,_l_u_n or ddddeeeevvvv==== _t_a_r_g_e_t,_l_u_n.  In the latter  case,
  25.      the  CD-Recorder has to be connected to the default SCSI bus
  26.      of  the  machine.   _S_c_s_i_b_u_s,  _t_a_r_g_e_t  and  _l_u_n  are  integer
  27.      numbers.  Some operating systems or SCSI transport implemen-
  28.      tations may require to specify a filename in  addition.   In
  29.      this  case  the  corect  syntax  for  the  device  is:  ddddeeeevvvv====
  30.      _d_e_v_i_c_e_n_a_m_e:_s_c_s_i_b_u_s,_t_a_r_g_e_t,  or  ddddeeeevvvv====  _d_e_v_i_c_e_n_a_m_e:_t_a_r_g_e_t,_l_u_n.
  31.      If  the  name  of the device node that has been specified on
  32.      such a system referres to exactly one SCSI device, a  short-
  33.      hand  in the form ddddeeeevvvv==== _d_e_v_i_c_e_n_a_m_e:@ or ddddeeeevvvv==== _d_e_v_i_c_e_n_a_m_e:@,_l_u_n
  34.      may be used instead of ddddeeeevvvv==== _d_e_v_i_c_e_n_a_m_e:_s_c_s_i_b_u_s,_t_a_r_g_e_t,
  35.  
  36.  
  37.      To make ccccddddrrrreeeeccccoooorrrrdddd portable to all UNIX platforms, the  syntax
  38.      ddddeeeevvvv====  _d_e_v_i_c_e_n_a_m_e:_s_c_s_i_b_u_s,_t_a_r_g_e_t, is preferred as is hides OS
  39.      specific knowledge about device  names  from  the  user.   A
  40.      specific  OS must not necessarily support a way to specify a
  41.      real   device   file   name   nor   a   way    to    specify
  42.      _s_c_s_i_b_u_s,_t_a_r_g_e_t,_l_u_n.
  43.  
  44.  
  45.      _S_c_s_i_b_u_s 0 is the default SCSI bus on the machine. Watch  the
  46.      boot   messages   for   more   information   or   look  into
  47.      ////vvvvaaaarrrr////aaaaddddmmmm////mmmmeeeessssssssaaaaggggeeeessss for more information about the SCSI confi-
  48.      guration  of  your  machine.  If you have problems to figure
  49.      out what values for _s_c_s_i_b_u_s,_t_a_r_g_e_t,_l_u_n should be  used,  try
  50.      the ----ssssccccaaaannnnbbbbuuuussss option of ccccddddrrrreeeeccccoooorrrrdddd described below.
  51.  
  52.  
  53.      If a file /etc/default/cdrecord exists, the parameter to the
  54.      ddddeeeevvvv==== option may also be a drive name label in said file (see
  55.      FILES section).
  56.  
  57.  
  58.      On SSSSVVVVrrrr4444 compliant systems, ccccddddrrrreeeeccccoooorrrrdddd uses the the  real  time
  59.      class  to  get  the  highest  scheduling  priotity  that  is
  60.  
  61.  
  62.  
  63. Joerg Schilling    Last change: Version 1.8.1                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  71.  
  72.  
  73.  
  74.      possible (higher than all  kernel  processes).   On  systems
  75.      with  PPPPOOOOSSSSIIIIXXXX  rrrreeeeaaaallll  ttttiiiimmmmeeee  sssscccchhhheeeedddduuuulllliiiinnnngggg  cdrecord uses real time
  76.      scheduling too, but may not be able to gain a priority  that
  77.      is higher than all kernel processes.
  78.  
  79.      In _T_r_a_c_k _A_t _O_n_c_e mode, each _t_r_a_c_k corresponds  to  a  single
  80.      file that contains the prepared data for that track.  If the
  81.      argument is `----', standard input is used for that track. Only
  82.      one track may be taken from _s_t_d_i_n.
  83.  
  84.  
  85. GGGGEEEENNNNEEEERRRRAAAALLLL OOOOPPPPTTTTIIIIOOOONNNNSSSS
  86.      General options must be before any track file name or  track
  87.      option.
  88.  
  89.      ----vvvveeeerrrrssssiiiioooonnnn
  90.           Print version information and exit.
  91.  
  92.      ----vvvv    Increment the level of general verbosity by one.  This
  93.           is  used  e.g.  to  display the progress of the writing
  94.           process.
  95.  
  96.      ----VVVV    Increment the verbose level in respect of SCSI command
  97.           transport  by one.  This helps to debug problems during
  98.           the writing process, that occur in the CD-Recorder.  If
  99.           you  get incomprehensible error messages you should use
  100.           this flag to get more detailed output.  ----VVVVVVVV  will  show
  101.           data buffer content in addition.  Using ----VVVV or ----VVVVVVVV slows
  102.           down the process and may be the  reason  for  a  buffer
  103.           underrun.  Using
  104.  
  105.      ----ddddeeeebbbbuuuugggg
  106.           Print additional debug messages. This may help to  find
  107.           out problems with sector sizes and sector types.  Using
  108.           ----ddddeeeebbbbuuuugggg slows down the process and may be the reason for
  109.           a buffer underrun.
  110.  
  111.      ----ffffoooorrrrcccceeee
  112.           Force  to  continue  on  some  errors.    This   option
  113.           currently implements some tricks that will allow you to
  114.           blank bad CD-RW disks.
  115.  
  116.      ----dddduuuummmmmmmmyyyy
  117.           The CD-Recorder  will  go  through  all  steps  of  the
  118.           recording  process,  but the laser is turned off during
  119.           this procedure.  It is recommended to run several tests
  120.           before  actually writing to a Compact Disk, if the tim-
  121.           ing and load response of the system is not known.
  122.  
  123.      ----ddddaaaaoooo  Set DDDDiiiisssskkkk AAAAtttt OOOOnnnncccceeee mmmmooooddddeeee.... This currently only works  with
  124.           MMC drives that support non raw SSSSeeeessssssssiiiioooonnnn AAAAtttt OOOOnnnncccceeee mode.
  125.  
  126.  
  127.  
  128.  
  129. Joerg Schilling    Last change: Version 1.8.1                   2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  137.  
  138.  
  139.  
  140.      ----mmmmuuuullllttttiiii
  141.           Allow multi session CD's to be made. This flag needs to
  142.           be  present  on  all  sessions of a multi session disk,
  143.           except you want to create a session that  will  be  the
  144.           last  session  on the media.  The fixation will be done
  145.           in a way that allows the CD-Recorder  to  append  addi-
  146.           tional sessions later. This is done by generation a TOC
  147.           with a link to the next program area. The so  generated
  148.           media  is  not  100%  compatible  to  manufactured CD's
  149.           (except for CDplus). Use only for  recording  of  multi
  150.           session  CD's.   If this option is present, the default
  151.           track type is CCCCDDDD----RRRROOOOMMMM XXXXAAAA mmmmooooddddeeee 2222.  The _S_o_n_y  drives  have
  152.           no  hardware support for CCCCDDDD----RRRROOOOMMMM XXXXAAAA mmmmooooddddeeee 2222.  You have to
  153.           specify the ----ddddaaaattttaaaa option in order to create multi  ses-
  154.           sion  disks  on these drives.  As long as cdrecord does
  155.           not have a coder for converting data sectors  to  audio
  156.           sectors,  you need to force CCCCDDDD----RRRROOOOMMMM sectors by including
  157.           the ----ddddaaaattttaaaa option if you like to record  a  multisession
  158.           disk  in  DAO/SAO mode.  Not all drives allow multises-
  159.           sion CD's in DAO/SAO mode.
  160.  
  161.      ----mmmmssssiiiinnnnffffoooo
  162.           Retrieve multi session info  in  a  form  suitable  for
  163.           mmmmkkkkiiiissssooooffffssss----1111....11110000 or later.
  164.  
  165.           This option makes only sense with a CD that contains at
  166.           least one closed session and is appendable (not finally
  167.           closed yet). Some drives create error messages  if  you
  168.           try  to  get  the multi session info for a disk that is
  169.           not suitable for this operation.
  170.  
  171.      ----ttttoooocccc  Retrieve and print out the table of content or PMA  of
  172.           a  CD.   With this option, ccccddddrrrreeeeccccoooorrrrdddd will work with CD-R
  173.           drives and with CD-ROM drives.
  174.  
  175.      ----aaaattttiiiipppp
  176.           Retrieve and print out the ATIP (absolute Time in  Pre-
  177.           groove) info of a CD recordable or CD rewritable media.
  178.           With this option, ccccddddrrrreeeeccccoooorrrrdddd will  try  to  retrieve  the
  179.           ATIP info. If the actual drive does not support to read
  180.           the ATIP info, it may be that only  a  reduced  set  of
  181.           information  records or even nothing is displayed. Only
  182.           a limited number of MMC  compliant  drives  support  to
  183.           read the ATIP info.
  184.  
  185.           If ccccddddrrrreeeeccccoooorrrrdddd is able to retrieve the lead-in start  time
  186.           for  the first session, it will try to decode and print
  187.           the manufacturer info from the media.
  188.  
  189.      ----ffffiiiixxxx  The disk will only be fixated (i.e. a TOC  for  a  CD-
  190.           Reader  will be written). This may be used, if for some
  191.           reason the disk has been written but not fixated.  This
  192.  
  193.  
  194.  
  195. Joerg Schilling    Last change: Version 1.8.1                   3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  203.  
  204.  
  205.  
  206.           option currently does not work with TEAC drives.
  207.  
  208.      ----nnnnooooffffiiiixxxx
  209.           Do not fixate the disk after writing the  tracks.  This
  210.           may  be  used  to create an audio disk in steps. An un-
  211.           fixated disk can usually not be used on a non CD-writer
  212.           type  drive but there are audio CD players that will be
  213.           able to play such a disk.
  214.  
  215.      ----wwwwaaaaiiiittttiiii
  216.           Wait for input to become available  on  standard  input
  217.           before  trying  to  open  the  SCSI driver. This allows
  218.           ccccddddrrrreeeeccccoooorrrrdddd to read it's input from a pipe even when writ-
  219.           ing  additional sessions to a multi session disk.  When
  220.           writing  another  session  to  a  multi  session  disk,
  221.           mmmmkkkkiiiissssooooffffssss  needs  to read the old session from the device
  222.           before writing output.  This cannot be done if ccccddddrrrreeeeccccoooorrrrdddd
  223.           opens the SCSI driver at the same time.
  224.  
  225.      ----llllooooaaaadddd
  226.           Load the media and exit. This only works  with  a  tray
  227.           loading mechanism but seems to be useful when using the
  228.           Kodak disk transporter.
  229.  
  230.      ----eeeejjjjeeeecccctttt
  231.           Eject disk after doing the work.   Some  Devices  (e.g.
  232.           Philips) need to eject the medium before creating a new
  233.           disk. Doing a -dummy test and  immediately  creating  a
  234.           real disk would not work on these devices.
  235.  
  236.      ssssppppeeeeeeeedddd====####
  237.           Set the speed factor of the writing process to #.  # is
  238.           an integer, representing a multiple of the audio speed.
  239.           This is about 150 KB/s for CD-ROM and  about  172  KB/s
  240.           for  CD-Audio.  If no _s_p_e_e_d option is present, ccccddddrrrreeeeccccoooorrrrdddd
  241.           will try to get the  speed  value  from  the  CCCCDDDDRRRR____SSSSPPPPEEEEEEEEDDDD
  242.           environment.   If  your drive has problems with _s_p_e_e_d=_2
  243.           or _s_p_e_e_d=_4, you should try _s_p_e_e_d=_0.
  244.  
  245.      bbbbllllaaaannnnkkkk====_t_y_p_e
  246.           Blank a CD-RW and exit or blank a CD-RW before writing.
  247.           The blanking type may be one of:
  248.  
  249.           help        Display a list of possible blanking types.
  250.  
  251.           all         Blank the entire disk. This may take a long
  252.                       time.
  253.  
  254.           fast        Minimally blank the disk. This  results  in
  255.                       erasing the PMA, the TOC and the pregap.
  256.  
  257.           track       Blank a track.
  258.  
  259.  
  260.  
  261. Joerg Schilling    Last change: Version 1.8.1                   4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  269.  
  270.  
  271.  
  272.           unreserve   Unreserve a reserved track.
  273.  
  274.           trtail      Blank the tail of a track.
  275.  
  276.           unclose     Unclose last session.
  277.  
  278.           session     Blank the last session.
  279.      If used together with the ----ffffoooorrrrcccceeee flag, this  option  may  be
  280.      used  to blank CD-RW disks that otherwise cannot be blanked.
  281.      Note that you may need to  specify  bbbbllllaaaannnnkkkk====_a_l_l  because  some
  282.      drives  will  not  continue  with certain types of bad CD-RW
  283.      disks. Note also that ccccddddeeeeccccoooorrrrdddd does it's best if the  ---- ffffoooorrrrcccceeee
  284.      flag  is used but it finally depends on the drive's firmware
  285.      whether the blanking operation will succeed or not.
  286.  
  287.      ffffssss====# Set the fifo (ring buffer) size to #.  You may use  the
  288.           same method as in dddddddd(1), ssssdddddddd(1) or ssssttttaaaarrrr(1).  The number
  289.           representing the size is taken in bytes  unless  other-
  290.           wise  specified.   If  a number is followed directly by
  291.           the letter `b', `k', `m', `s' of `f', the size is  mul-
  292.           tiplied  by 512, 1024, 1024*1024, 2048 or 2352.  If the
  293.           size consists of numbers separated by `x' or `*',  mul-
  294.           tiplication  of  the  two  numbers  is performed.  Thus
  295.           _f_s=_1_0_x_6_3_k will specify a fifo size of 630 kBytes.
  296.  
  297.           The size specified by the  _f_s=  argument  includes  the
  298.           shared  memory  that is needed for administration. This
  299.           is at least one page of memory.  If no  _f_s=  option  is
  300.           present,  ccccddddrrrreeeeccccoooorrrrdddd  will try to get the fifo size value
  301.           from the CCCCDDDDRRRR____FFFFIIIIFFFFOOOOSSSSIIIIZZZZEEEE environment.   The  default  fifo
  302.           size is currently 4 MB.
  303.  
  304.           The fifo is used to increase  buffering  for  the  real
  305.           time  writing  process.   It  allows to run a pipe from
  306.           mmmmkkkkiiiissssooooffffssss directly into ccccddddrrrreeeeccccoooorrrrdddd.  If the fifo is  active
  307.           and a pipe from mmmmkkkkiiiissssooooffffssss into ccccddddrrrreeeeccccoooorrrrdddd is used to create
  308.           a CD, ccccddddrrrreeeeccccoooorrrrdddd will abort prior to do any modifications
  309.           on  the  disk if mmmmkkkkiiiissssooooffffssss dies before it starts writing.
  310.           The recommended fifo size is between 4 and  32  MBytes.
  311.           As  a  rule  of thumb, the fifo size should be at least
  312.           equal to the size of the internal  buffer  of  the  CD-
  313.           Recorder  and  no more than half of the physical amount
  314.           of RAM available in the machine.  If the fifo  size  is
  315.           big enough, the fifo statistics will print a fifo empty
  316.           count of zero and the fifo min fill is not  below  20%.
  317.           It  is  not wise to use too much space for the fifo. If
  318.           you need more than 8 MB  to  write  a  CD  on  an  idle
  319.           machine,  your  machine  is  either  underpowered,  has
  320.           hardware problems  or  is  mis-configured.   The  sun4c
  321.           architecture  (e.g. a Sparcstation-2) has only MMU page
  322.           table entries for 16 MBytes  per  process.  Using  more
  323.           than  14  MBytes  for  the fifo may cause the operating
  324.  
  325.  
  326.  
  327. Joerg Schilling    Last change: Version 1.8.1                   5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  335.  
  336.  
  337.  
  338.           system in this case to spend much  time  to  constantly
  339.           reload  the  MMU tables. Newer machines from Sun do not
  340.           have this MMU hardware problem. I have  no  information
  341.           on PC-hardware reflecting this problem.
  342.  
  343.           If you have buffer underruns or  similar  problems  and
  344.           observe  a  zero  _f_i_f_o  _e_m_p_t_y  _c_o_u_n_t, you have hardware
  345.           problems. The fifo size in this case is sufficient.
  346.  
  347.      ddddeeeevvvv====_t_a_r_g_e_t
  348.           Sets the SCSI target for  the  CD-Recorder,  see  notes
  349.           above.  A typical device specification is ddddeeeevvvv====_6,_0 .  If
  350.           a filename must be provided together with the numerical
  351.           target  specification,  the  filename is implementation
  352.           specific.  The correct filename in  this  case  can  be
  353.           found  in  the  system  specific  manuals of the target
  354.           operating system.  On a _F_r_e_e_B_S_D system without _C_A_M sup-
  355.           port,   you  need  to  use  the  control  device  (e.g.
  356.           /_d_e_v/_r_c_d_0._c_t_l).  A correct device specification in this
  357.           case may be ddddeeeevvvv====/_d_e_v/_r_c_d_0._c_t_l:@ .
  358.  
  359.           On Linux, drives connected to a parallel  port  adapter
  360.           are  mapped  to  a virtual SCSI bus. Different adapters
  361.           are mapped to different targets on  this  virtual  SCSI
  362.           bus.
  363.  
  364.           If no _d_e_v option is present, ccccddddrrrreeeeccccoooorrrrdddd will try  to  get
  365.           the device from the CCCCDDDDRRRR____DDDDEEEEVVVVIIIICCCCEEEE environment.
  366.  
  367.           If the argument to the ddddeeeevvvv==== option does not contain the
  368.           characters  ',',  '/', '@' or ':', it is interpreted as
  369.           an  label  name  that  may  be  found   in   the   file
  370.           /etc/default/cdrecord (see FILES section).
  371.  
  372.      ttttiiiimmmmeeeeoooouuuutttt====#
  373.           Set the default SCSI command timeout value to  #.   The
  374.           default  SCSI  command  timeout  is the minimum timeout
  375.           used for sending SCSI  commands.   If  a  SCSI  command
  376.           fails  due  to  a  timeout,  you  may  try to raise the
  377.           default SCSI command timeout above the timeout value of
  378.           the failed command.  If the command runs correctly with
  379.           a raised command  timeout,  please  report  the  better
  380.           timeout  value  and  the  corresponding  command to the
  381.           author  of  the  program.   If  no  _t_i_m_e_o_u_t  option  is
  382.           present, a default timeout of 40 seconds is used.
  383.  
  384.      ddddrrrriiiivvvveeeerrrr====_n_a_m_e
  385.           Allows to use a user supplied driver name for the  dev-
  386.           ice.    To   get   a   list  of  possible  drivers  use
  387.           ddddrrrriiiivvvveeeerrrr====hhhheeeellllpppp.  The reason  for  the  existence  of  this
  388.           option  is  to  allow users to use ccccddddrrrreeeeccccoooorrrrdddd with drives
  389.           that are similar to  supported  drives  but  not  known
  390.  
  391.  
  392.  
  393. Joerg Schilling    Last change: Version 1.8.1                   6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  401.  
  402.  
  403.  
  404.           directly  by  ccccddddrrrreeeeccccoooorrrrdddd.   Use  this option with extreme
  405.           care. If a wrong driver is used for a device, the  pos-
  406.           sibility  of  creating  corrupted  disks  is high.  The
  407.           minimum problem related to a wrong driver is that the ----
  408.           ssssppppeeeeeeeedddd or ----dddduuuummmmmmmmyyyy will not work.
  409.  
  410.           There are two  special  driver  entries  in  the  list:
  411.           ccccddddrrrr____ssssiiiimmmmuuuullll  and  ddddvvvvdddd____ssssiiiimmmmuuuullll.   These  driver  entries are
  412.           designed to make timing tests at any  speed  or  timing
  413.           tests for drives that do not support the ----dddduuuummmmmmmmyyyy option.
  414.           The simulation drivers implement a drive with a  buffer
  415.           size   of   1MB   that   can   be   changed   via   the
  416.           CCCCDDDDRRRR____SSSSIIIIMMMMUUUULLLL____BBBBUUUUFFFFSSSSIIIIZZZZEEEE environment variable.  The simultaion
  417.           driver  correctly simulates even a buffer underrun con-
  418.           dition.  If the ----dddduuuummmmmmmmyyyy option is  present,  the  simul-
  419.           taion is not aborted in case of a buffer underrun.
  420.  
  421.      ddddrrrriiiivvvveeeerrrrooooppppttttssss====_o_p_t_i_o_n _l_i_s_t
  422.           Set driver specific options. The options are  specified
  423.           a comma separated list.  To get a list of valid options
  424.           use ddddrrrriiiivvvveeeerrrrooooppppttttssss====_h_e_l_p  together  with  the   - _c_h_e_c_k_d_r_i_v_e
  425.           option.   Currently only the bbbbuuuurrrrnnnnpppprrrrooooooooffff option is imple-
  426.           mented to support Buffer Underrun  Proof  writing  with
  427.           drives that use the Sanyo BURN-Proof technology.
  428.  
  429.  
  430.      ----cccchhhheeeecccckkkkddddrrrriiiivvvveeee
  431.           Checks if a driver for the current drive is present and
  432.           exit.   If  the  drive  is a known drive, ccccddddrrrreeeeccccoooorrrrdddd uses
  433.           exit code 0.
  434.  
  435.      ----pppprrrrccccaaaapppp
  436.           Print the drive capabilities for  SCSI-3/mmc  compliant
  437.           drives  as  obtained from mode page 0x2A. Values marked
  438.           with _k_B use 1000 bytes as kilo-byte, values marked with
  439.           _K_B use 1024 bytes as Kilo-byte.
  440.  
  441.      ----iiiinnnnqqqq  Do an inquiry for the drive, print  the  inquiry  info
  442.           and exit.
  443.  
  444.      ----ssssccccaaaannnnbbbbuuuussss
  445.           Scan all SCSI devices on all SCSI busses and print  the
  446.           inquiry  strings.  This option may be used to find SCSI
  447.           address of the CD-Recorder on a  system.   The  numbers
  448.           printed out as labels are computed by: bbbbuuuussss **** 111100000000 ++++ ttttaaaarrrr----
  449.           ggggeeeetttt
  450.  
  451.      ----rrrreeeesssseeeetttt
  452.           Try to reset the SCSI bus  where  the  CD  recorder  is
  453.           located. This works not on all operating systems.
  454.  
  455.      ----iiiiggggnnnnssssiiiizzzzeeee
  456.  
  457.  
  458.  
  459. Joerg Schilling    Last change: Version 1.8.1                   7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  467.  
  468.  
  469.  
  470.           Ignore the known  size  of  the  medium.  This  options
  471.           should  be  used  with extreme care, it exists only for
  472.           debugging purposes don't use it for other reasons.   It
  473.           is not needed to write disks with more than the nominal
  474.           capacity.
  475.  
  476.      ----uuuusssseeeeiiiinnnnffffoooo
  477.           Use *.inf files to overwrite audio  options.   If  this
  478.           option  is  used,  the  pregap size information is read
  479.           from the *.inf file that is associated  with  the  file
  480.           that contains the audio data for a track.
  481.  
  482.      ddddeeeeffffpppprrrreeeeggggaaaapppp=#
  483.           Set the default pre-gap  size  for  all  tracks  except
  484.           track number 1.  This option currently only makes sense
  485.           with the TEAC drive when creating  track-at-once  disks
  486.           without the 2 second silence before each track.
  487.           This option may go away in future.
  488.  
  489.      ----ppppaaaacccckkkkeeeetttt
  490.           Set PPPPaaaacccckkkkeeeetttt wwwwrrrriiiittttiiiinnnngggg mmmmooooddddeeee.... This is an experimental inter-
  491.           face.
  492.  
  493.      ppppkkkkttttssssiiiizzzzeeee=#
  494.           Set the paket size to  #,  forces  fixed  packet  mode.
  495.           This is an experimental interface.
  496.  
  497.      ----nnnnoooocccclllloooosssseeee
  498.           Do not close the current track,  useful  only  when  in
  499.           packet  writing  mode.   This is an experimental inter-
  500.           face.
  501.  
  502.      mmmmccccnnnn====mmmmeeeedddd____ccccaaaatttt____nnnnrrrr
  503.           Set the MMMMeeeeddddiiiiaaaa CCCCaaaattttaaaalllloooogggg NNNNuuuummmmbbbbeeeerrrr of the CD to _m_e_d__c_a_t__n_r.
  504.  
  505.  
  506. TTTTRRRRAAAACCCCKKKK OOOOPPPPTTTTIIIIOOOONNNNSSSS
  507.      Track options may be mixed with track file names.
  508.  
  509.      iiiissssrrrrcccc====IIIISSSSRRRRCCCC____nnnnuuuummmmbbbbeeeerrrr
  510.           Set the IIIInnnntttteeeerrrrnnnnaaaattttiiiioooonnnnaaaallll SSSSttttaaaannnnddddaaaarrrrdddd RRRReeeeccccoooorrrrddddiiiinnnngggg NNNNuuuummmmbbbbeeeerrrr for the
  511.           next track to _I_S_R_C__n_u_m_b_e_r.
  512.  
  513.      iiiinnnnddddeeeexxxx====_l_i_s_t
  514.           Sets an index list for the next track.  In  index  list
  515.           is  a comma separated list of numbers that are counting
  516.           from index 1. The first entry in this list must contain
  517.           a 0, the following numbers must be an ascending list of
  518.           numbers (counting in 1/75 seconds) that  represent  the
  519.           start  of  the  indices.  An  index  list  in the form:
  520.           0,7500,15000 sets index 1 to the start  of  the  track,
  521.           index  2  100  seconds  from the start of the track and
  522.  
  523.  
  524.  
  525. Joerg Schilling    Last change: Version 1.8.1                   8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  533.  
  534.  
  535.  
  536.           index 3 200 seconds from the start of the track.
  537.  
  538.      ----aaaauuuuddddiiiioooo
  539.           If this flag is  present,  all  subsequent  tracks  are
  540.           written  in  CCCCDDDD----DDDDAAAA  (similar to Red Book) audio format.
  541.           The file with  data  for  this  tracks  should  contain
  542.           stereo, 16-bit digital audio with 44100 samples/s.  The
  543.           byte order should be the following: MSB left, LSB left,
  544.           MSB  right,  LSB  right,  MSB left and so on. The track
  545.           should be a multiple of 2352 bytes. It is not  possible
  546.           to put the master image of an audio track on a raw disk
  547.           because data will be read in  multiple  of  2352  bytes
  548.           during the recording process.
  549.  
  550.           If a filename ends in ._a_u or  ._w_a_v  the  file  is  con-
  551.           sidered  to  be a structured audio data file.  CCCCddddrrrreeeeccccoooorrrrdddd
  552.           assumes that the file in this case is a Sun audio  file
  553.           or  a  Microsoft  .WAV file and extracts the audio data
  554.           from the files by skipping over  the  non-audio  header
  555.           information.   In  all  other cases, cdrecord will only
  556.           work correctly if the audio data stream does  not  have
  557.           any header.  Because many structured audio files do not
  558.           have an integral number of blocks  (1/75th  second)  in
  559.           length,  it  is  often  necessary  to  specify the ----ppppaaaadddd
  560.           option as well.  ccccddddrrrreeeeccccoooorrrrdddd recognizes that audio data in
  561.           a  .WAV  file  is  stored in Intel (little-endian) byte
  562.           order, and will automatically byte-swap the data if the
  563.           CD  recorder  requires  big-endian  data. CCCCddddrrrreeeeccccoooorrrrdddd will
  564.           reject any audio file that does not match the Red  Book
  565.           requirements  of 16-bit stereo samples in PCM coding at
  566.           44100 samples/second.
  567.  
  568.           Using other structured audio data formats as  input  to
  569.           ccccddddrrrreeeeccccoooorrrrdddd will usually work if the structure of the data
  570.           is the structure described above (raw pcm data in  big-
  571.           endian  byte  order).   However,  if  the  data  format
  572.           includes a header, you will hear a click at  the  start
  573.           of a track.
  574.  
  575.           If neither -_d_a_t_a  nor   - _a_u_d_i_o  have  been  specified,
  576.           ccccddddrrrreeeeccccoooorrrrdddd  defaults to -_a_u_d_i_o for all filenames that end
  577.           in ._a_u or ._w_a_v and to -_d_a_t_a for all other files.
  578.  
  579.      ----sssswwwwaaaabbbb
  580.           If this flag is present, audio data is assumed to be in
  581.           byte-swapped  (little-endian) order.  Some types of CD-
  582.           Writers e.g. Yamaha, Sony and the new SCSI-3/mmc drives
  583.           require  audio  data  to  be presented in little-endian
  584.           order, while other writers require  audio  data  to  be
  585.           presented  in  the big-endian (network) byte order nor-
  586.           mally used by the SCSI protocol.  CCCCddddrrrreeeeccccoooorrrrdddd knows  if  a
  587.           CD-Recorder  needs  audio data in big- or little-endian
  588.  
  589.  
  590.  
  591. Joerg Schilling    Last change: Version 1.8.1                   9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  599.  
  600.  
  601.  
  602.           order, and corrects the byte order of the  data  stream
  603.           to match the needs of the recorder.  You only need the
  604.           -_s_w_a_b flag if your data stream  is  in  Intel  (little-
  605.           endian) byte order.
  606.  
  607.           Note that the verbose output of ccccddddrrrreeeeccccoooorrrrdddd will show  you
  608.           if  swapping is necessary to make the byte order of the
  609.           input data fit the required byte order of the recorder.
  610.           CCCCddddrrrreeeeccccoooorrrrdddd  will not show you if the -_s_w_a_b flag was actu-
  611.           ally present for a track.
  612.  
  613.      ----ddddaaaattttaaaa
  614.           If this flag is  present,  all  subsequent  tracks  are
  615.           written in CCCCDDDD----RRRROOOOMMMM mmmmooooddddeeee 1111 (Yellow Book) format. The data
  616.           is a multiple of 2048 bytes.  The file with track  data
  617.           should  contain  an  IIIISSSSOOOO----9999666666660000  or RRRRoooocccckkkk RRRRiiiiddddggggeeee filesystem
  618.           image (see mmmmkkkkiiiissssooooffffssss for more details). If the track data
  619.           is an uuuuffffssss filesystem image, fragment size should be set
  620.           to 2 KB or more to allow CR-drives  with  2  KB  sector
  621.           size to to be used for reading.
  622.  
  623.           -data is the default, if no other flag is present.
  624.  
  625.           If neither -_d_a_t_a  nor   - _a_u_d_i_o  have  been  specified,
  626.           ccccddddrrrreeeeccccoooorrrrdddd  defaults to -_a_u_d_i_o for all filenames that end
  627.           in ._a_u or ._w_a_v and to -_d_a_t_a for all other files.
  628.  
  629.      ----mmmmooooddddeeee2222
  630.           If this flag is  present,  all  subsequent  tracks  are
  631.           written in CCCCDDDD----RRRROOOOMMMM mmmmooooddddeeee 2222 format. The data is a multiple
  632.           of 2048 bytes.
  633.  
  634.      ----xxxxaaaa1111  If this flag is present,  all  subsequent  tracks  are
  635.           written  in CCCCDDDD----RRRROOOOMMMM XXXXAAAA mmmmooooddddeeee 1111 format. The data is a mul-
  636.           tiple of 2048 bytes.
  637.  
  638.      ----xxxxaaaa2222  If this flag is present,  all  subsequent  tracks  are
  639.           written  in CCCCDDDD----RRRROOOOMMMM XXXXAAAA mmmmooooddddeeee 2222 format. The data is a mul-
  640.           tiple of 2048 bytes.
  641.  
  642.      ----ccccddddiiii  If this flag is present,  all  subsequent  tracks  are
  643.           written  in  CCCCDDDDIIII format. The data is a multiple of 2048
  644.           bytes.
  645.  
  646.      ----iiiissssoooossssiiiizzzzeeee
  647.           Use the IIIISSSSOOOO----9999666666660000 file system size as the  size  of  the
  648.           next  track.  This option is needed if you want to read
  649.           the image of a track from a raw disk partition or on  a
  650.           master  CD.  In  the  first case the option ----iiiissssoooossssiiiizzzzeeee is
  651.           needed to limit the size of the CD to the size  of  the
  652.           ISO filesystem.  In the second case the option ----iiiissssoooossssiiiizzzzeeee
  653.           is needed to prevent ccccddddrrrreeeeccccoooorrrrdddd from reading the two  run
  654.  
  655.  
  656.  
  657. Joerg Schilling    Last change: Version 1.8.1                  10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  665.  
  666.  
  667.  
  668.           out  blocks  that  are  appended by each CD-recorder in
  669.           track at once mode. These two run out blocks cannot  be
  670.           read  and  would  cause  a  buffer under run that would
  671.           cause a defective copy.  Do  not  use  this  option  if
  672.           ccccddddrrrreeeeccccoooorrrrdddd  reads the track data from _s_t_d_i_n.  This option
  673.           currently cannot be used to determine  the  size  of  a
  674.           file system if the multi session option is present.
  675.  
  676.      ----ppppaaaadddd  If the track is a data track,  15  sectors  of  zeroed
  677.           data  will  be added to the end of this and each subse-
  678.           quent data track.  In this case, the  ---- ppppaaaadddd  option  is
  679.           superseded  by the ppppaaaaddddssssiiiizzzzeeee==== option. It will remain how-
  680.           ever as a shorthand for  ppppaaaaddddssssiiiizzzzeeee====11115555ssss....   If  the   - _p_a_d
  681.           option  refers to an audio track, ccccddddrrrreeeeccccoooorrrrdddd will pad the
  682.           audio data to be a multiple of 2352  bytes.  The  audio
  683.           data  padding is done with binary zeroes which is equal
  684.           to absolute silence.
  685.  
  686.           ----ppppaaaadddd remains valid until disabled by ----nnnnooooppppaaaadddd.
  687.  
  688.      ppppaaaaddddssssiiiizzzzeeee====#
  689.           Set the amount of data to be appended as padding to the
  690.           next  track  to #.  Opposed to the behavior of the ----ppppaaaadddd
  691.           option, the value for _p_a_d_s_i_z_e= is  reset  to  zero  for
  692.           each new track.  See ffffssss= option for possible arguments.
  693.           Use this option if your CD-drive is not  able  to  read
  694.           the  last  sectors of a track or if you want to be able
  695.           to read the CD on a  LLLLiiiinnnnuuuuxxxx  system  with  the  ISO-9660
  696.           filesystem  read  ahead  bug.  If an empty file is used
  697.           for track data, this option may be  used  to  create  a
  698.           disk that is entirely made of padding.
  699.  
  700.      ----nnnnooooppppaaaadddd
  701.           Do not pad the following tracks - the default.
  702.  
  703.      pppprrrreeeeggggaaaapppp=#
  704.           Set the  pre-gap size for the next track.  This  option
  705.           currently  only  makes  sense  with the TEAC drive when
  706.           creating  track-at-once  disks  without  the  2  second
  707.           silence before each track.
  708.           This option may go away in future.
  709.  
  710.      ----pppprrrreeeeeeeemmmmpppp
  711.           If this flag is present, all TOC entries for subsequent
  712.           audio tracks will indicate that the audio data has been
  713.           sampled with 50/15 ╡sec preemphasis.  The data, however
  714.           is not modified during the process of transferring from
  715.           file to disk. This option has no effect on data tracks.
  716.  
  717.      ----nnnnoooopppprrrreeeeeeeemmmmpppp
  718.           If this flag is present, all TOC entries for subsequent
  719.           audio tracks will indicate that the audio data has been
  720.  
  721.  
  722.  
  723. Joerg Schilling    Last change: Version 1.8.1                  11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  731.  
  732.  
  733.  
  734.           mastered with linear data - this is the default.
  735.  
  736.      ttttssssiiiizzzzeeee====####
  737.           If the master image for the next track has been  stored
  738.           on  a  raw  disk,  use this option to specify the valid
  739.           amount of data on this disk. If the image of  the  next
  740.           track  is  stored  in  a regular file, the size of that
  741.           file is taken to determine the length  of  this  track.
  742.           If  the track contains an ISO 9660 filesystem image use
  743.           the -_i_s_o_s_i_z_e option to determine  the  length  of  that
  744.           filesystem image.
  745.           In Disk at Once mode and with some drives that use  the
  746.           TEAC programming interface, even in Track at Once mode,
  747.           ccccddddrrrreeeeccccoooorrrrdddd needs to know the size of  each  track  before
  748.           starting  to  write the disk.  Cdrecord now checks this
  749.           and aborts before starting to write.  If  this  happens
  750.           you will need to run mmmmkkkkiiiissssooooffffssss ----pppprrrriiiinnnntttt----ssssiiiizzzzeeee before and use
  751.           the output as an  argument  to  the  ttttssssiiiizzzzeeee=  option  of
  752.           ccccddddrrrreeeeccccoooorrrrdddd.
  753.           See ffffssss= option for possible arguments.
  754.  
  755.  
  756. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  757.      For all examples below, it will  be  assumed  that  the  CD-
  758.      Recorder  is  connected  to  the  primary  SCSI  bus  of the
  759.      machine. The SCSI target id is set to 2.
  760.  
  761.      To record a pure CD-ROM at double speed, using data from the
  762.      file _c_d_i_m_a_g_e._r_a_w:
  763.  
  764.          cdrecord -v speed=2 dev=2,0 cdimage.raw
  765.  
  766.      To create an image for a ISO 9660 filesystem with Rock Ridge
  767.      extensions:
  768.  
  769.          mkisofs -R -o cdimage.raw /home/joerg/master/tree
  770.  
  771.      To check the resulting file before writing to CD on Solaris:
  772.  
  773.          mount -r -F fbk -o type=hsfs /dev/fbk0:cdimage.raw /mnt
  774.  
  775.      On Linux:
  776.  
  777.          mount cdimage.raw -r -t iso9660 -o loop /mnt
  778.  
  779.      Go on with:
  780.          ls -lR /mnt
  781.          umount /mnt
  782.  
  783.      If the overall speed of the system  is  sufficient  and  the
  784.      structure  of  the  filesystem  is not too complex, cdrecord
  785.      will  run  without  creating  an  image  of  the  ISO   9660
  786.  
  787.  
  788.  
  789. Joerg Schilling    Last change: Version 1.8.1                  12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  797.  
  798.  
  799.  
  800.      filesystem. Simply run the pipeline:
  801.  
  802.          mkisofs -R /master/tree |  cdrecord  - v  fs=6m  speed=2
  803.      dev=2,0 -
  804.  
  805.      The recommended minimum fifo size for running this  pipeline
  806.      is  4  MBytes.   As  the  default fifo size is 4 MB, the ffffssss====
  807.      option needs only be present if you want to use a  different
  808.      fifo size.  If your system is loaded, you should run mkisofs
  809.      in the real time  class  too.   To  raise  the  priority  of
  810.      mmmmkkkkiiiissssooooffffssss replace the command
  811.  
  812.          mkisofs -R /master/tree
  813.      by
  814.          priocntl -e -c RT -p 59 mkisofs -R /master/tree
  815.  
  816.      on Solaris and by
  817.  
  818.          nice --18 mkisofs -R /master/tree
  819.  
  820.      on systems that  don't  have  UUUUNNNNIIIIXXXX  IIIInnnntttteeeerrrrnnnnaaaattttiiiioooonnnnaaaallll  compliant
  821.      realtime scheduling.
  822.  
  823.      Cdrecord runs at priority 59  on  Solaris,  you  should  run
  824.      mkisofs  at  no more than priority 58. On other systems, you
  825.      should run mkisofs at no less than nice --18.
  826.  
  827.      Creating a CD-ROM without file system image on disk has been
  828.      tested  on  a  Sparcstation-2  with a Yamaha CDR-400. It did
  829.      work up to quad speed when the machine was  not  loaded.   A
  830.      faster  machine may be able to handle quad speed also in the
  831.      loaded case.
  832.  
  833.      To record a pure CD-DA (audio) at single  speed,  with  each
  834.      track   contained   in   a   file   named   _t_r_a_c_k_0_1._c_d_a_u_d_i_o,
  835.      _t_r_a_c_k_0_2._c_d_a_u_d_i_o, etc:
  836.  
  837.          cdrecord -v speed=1 dev=2,0 -audio track*.cdaudio
  838.  
  839.      To check if it will be ok to use double speed for the  exam-
  840.      ple above. Use the dummy write option:
  841.  
  842.          cdrecord -v -dummy speed=2 dev=2,0 -audio track*.cdaudio
  843.  
  844.      To record a mixed-mode CD with an ISO 9660  filesystem  from
  845.      _c_d_i_m_a_g_e._r_a_w on the first track, the other tracks being audio
  846.      tracks from the files _t_r_a_c_k_0_1._c_d_a_u_d_i_o, _t_r_a_c_k_0_2._c_d_a_u_d_i_o, etc:
  847.  
  848.          cdrecord  - v  - dummy  dev=2,0   cdimage.raw   -  audio
  849.      track*.cdaudio
  850.  
  851.  
  852.  
  853.  
  854.  
  855. Joerg Schilling    Last change: Version 1.8.1                  13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  863.  
  864.  
  865.  
  866.      To handle drives that need to  know  the  size  of  a  track
  867.      before starting to write, first run
  868.  
  869.          mkisofs -R -q -print-size /master/tree
  870.  
  871.      and then run
  872.  
  873.          mkisofs  -R  /master/tree  |  cdrecord  speed=2  dev=2,0
  874.      tsize=XXXs -
  875.  
  876.      where _X_X_X is replaced by the output of the previous  run  of
  877.      mkisofs.
  878.  
  879.      To copy an audio CD in the most accurate way, first run
  880.  
  881.          cdda2wav -v255 -D2,0 -B -Owav
  882.  
  883.      and then run
  884.  
  885.          cdrecord -v dev=2,0 -dao -useinfo  *.wav
  886.  
  887. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  888.      CDR_DEVICE
  889.           This may either hold a device identifier that is  suit-
  890.           able  to the open call of the SCSI transport library or
  891.           a label in the file /etc/default/cdrecord.
  892.  
  893.      CDR_SPEED
  894.           Sets the default speed value for writing (see  also   ----
  895.           ssssppppeeeeeeeedddd option).
  896.  
  897.      CDR_FIFOSIZE
  898.           Sets the default  size  of  the  FIFO  (see  also  ffffssss====####
  899.           option).
  900.  
  901.  
  902. FFFFIIIILLLLEEEESSSS
  903.      /etc/default/cdrecord
  904.           Default values can be set for the following options  in
  905.           /etc/default/cdrecord.   For  example:  CDR_FIFOSIZE=8m
  906.           or CDR_SPEED=2
  907.  
  908.           CDR_DEVICE
  909.                This may either hold a device identifier  that  is
  910.                suitable  to  the  open call of the SCSI transport
  911.                library    or    a    label    in     the     file
  912.                /etc/default/cdrecord  that  allows  to identify a
  913.                specific drive on the system.
  914.  
  915.           CDR_SPEED
  916.                Sets the default speed value for writing (see also
  917.                ----ssssppppeeeeeeeedddd option).
  918.  
  919.  
  920.  
  921. Joerg Schilling    Last change: Version 1.8.1                  14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  929.  
  930.  
  931.  
  932.           CDR_FIFOSIZE
  933.                Sets the default size of the FIFO (see  also  ffffssss====####
  934.                option).
  935.  
  936.           Any other label
  937.                is an identifier for a specific drive on the  sys-
  938.                tem.  Such an identifier may not contain the char-
  939.                acters ',', '/', '@' or ':'.
  940.  
  941.                Each line that follows  a  label  contains  a  TAB
  942.                separates  list  of items.  Currently, three items
  943.                are recognized: the SCSI  ID  of  the  drive,  the
  944.                default  speed  that should be used for this drive
  945.                and the default FIFO size that should be used  for
  946.                this  drive. The values for _s_p_e_e_d and _f_i_f_o_s_i_z_e may
  947.                be set to -1 to tell cdrecord to  use  the  global
  948.                defaults.  A typical line may look this way:
  949.  
  950.                teac1= 0,5,0   4    8m
  951.  
  952.                yamaha= 1,6,0  -1   -1
  953.  
  954.                This tells ccccddddrrrreeeeccccoooorrrrdddd that a drive named _t_e_a_c_1 is at
  955.                scsibus 0, target 5, lun 0 and should be used with
  956.                speed 4 and a FIFO size of 8 MB.  A  second  drive
  957.                may  be  found  at  scsibus 1, target 6, lun 0 and
  958.                uses the default speed and the default FIFO size.
  959.  
  960.  
  961. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  962.      mmmmkkkkiiiissssooooffffssss(1), ssssccccgggg(7), ffffbbbbkkkk(7).
  963.  
  964.  
  965. NNNNOOOOTTTTEEEESSSS
  966.      Disks made in TTTTrrrraaaacccckkkk AAAAtttt OOOOnnnncccceeee mode are not suitable as a  mas-
  967.      ter  for  direct  mass  production by CD manufacturers.  You
  968.      will need the ddddiiiisssskkkk aaaatttt oooonnnncccceeee  option  to  record  such  disks.
  969.      Nevertheless  the  disks made in TTTTrrrraaaacccckkkk AAAAtttt OOOOnnnncccceeee will normally
  970.      be read in all CD players. Some old audio CD players however
  971.      may produce a two second click between two audio tracks.
  972.  
  973.      The minimal size of a track is 4 seconds or 300 sectors.  If
  974.      you  write  smaller  tracks,  the CD-Recorder will add dummy
  975.      blocks. This is not an error,  even  though  the  SCSI-error
  976.      message looks this way.
  977.  
  978.      CCCCddddrrrreeeeccccoooorrrrdddd has been tested  on  an  upgraded  Philips  CDD-521
  979.      recorder at single and double speed on a SparcStation 20/502
  980.      with no problems, slower computer systems should work  also.
  981.      The  newer  Philips/HP/Plasmon/Grundig  drives  as  well  as
  982.      Yamaha CDR-100 and CDR-102 work also.  The  Plasmon  RF-4100
  983.      work,  but  has not tested in multi session.  A Philips CDD-
  984.  
  985.  
  986.  
  987. Joerg Schilling    Last change: Version 1.8.1                  15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  995.  
  996.  
  997.  
  998.      521 that has not been upgraded  will  not  work.   The  Sony
  999.      CDU-924  has  been  tested, but does not support XA-mode2 in
  1000.      hardware.  The sony therefore cannot create conforming multi
  1001.      session  disks.   The  Ricoh RO-1420C works, but some people
  1002.      seem to have problems to use them with speed=2, try  speed=0
  1003.      in this case.
  1004.  
  1005.      The Yamaha CDR-400 and all new SCSI-3/mmc conforming  drives
  1006.      are supported in single and multi-session.
  1007.  
  1008.      You should run several tests in all supported speeds of your
  1009.      drive  with  the   ---- dddduuuummmmmmmmyyyy option turned on if you are using
  1010.      ccccddddrrrreeeeccccoooorrrrdddd on an unknown system. Writing a CD  is  a  realtime
  1011.      process.  NNNNFFFFSSSS  will not always deliver constantly the needed
  1012.      data rates.  If you want to use ccccddddrrrreeeeccccoooorrrrdddd with CD-images that
  1013.      are  located  on  a NNNNFFFFSSSS mounted filesystem, be sure that the
  1014.      fifo size is big enough.  I used ccccddddrrrreeeeccccoooorrrrdddd with  with  medium
  1015.      load   on   a   SS20/502   and  even  at  quad  speed  on  a
  1016.      Sparcstation-2 which was heavily loaded, but  it  is  recom-
  1017.      mended  to  leave  the  system as lightly loaded as possible
  1018.      while writing a CD.  If you want to make  sure  that  buffer
  1019.      underrungs  are  not caused by your source disk, you may use
  1020.      the command
  1021.  
  1022.          ccccddddrrrreeeeccccoooorrrrdddd ----dddduuuummmmmmmmyyyy ddddeeeevvvv====2222,,,,0000 ppppaaaaddddssssiiiizzzzeeee====666600000000mmmm ////ddddeeeevvvv////nnnnuuuullllllll
  1023.  
  1024.      to create a disk  that  is  entirely  made  of  dummy  data.
  1025.      CCCCddddrrrreeeeccccoooorrrrdddd needs to run as root to get access to the ////ddddeeeevvvv////ssssccccgggg????
  1026.      device nodes and to be able to lock itself into memory.
  1027.  
  1028.      If you don't want to allow users to become root on your sys-
  1029.      tem, ccccddddrrrreeeeccccoooorrrrdddd may safely be installed suid root. This allows
  1030.      all users or a group of users with no root privileges to use
  1031.      ccccddddrrrreeeeccccoooorrrrdddd....  CCCCddddrrrreeeeccccoooorrrrdddd  in  this  case checks, if the real user
  1032.      would have been able to read the specified files.   To  give
  1033.      all user access to use ccccddddrrrreeeeccccoooorrrrdddd,,,, enter:
  1034.  
  1035.           chown root /usr/local/bin/cdrecord
  1036.           chmod 4711 /usr/local/bin/cdrecord
  1037.  
  1038.      To give a restricted  group  of  users  access  to  cdrecord
  1039.      enter:
  1040.  
  1041.           chown root /usr/local/bin/cdrecord
  1042.           chgrp cdburners /usr/local/bin/cdrecord
  1043.           chmod 4710 /usr/local/bin/cdrecord
  1044.  
  1045.      and add a group _c_d_b_u_r_n_e_r_s on your system.
  1046.  
  1047.      Never give write permissions  for  non  root  users  to  the
  1048.      /_d_e_v/_s_c_g?   devices   unless  you  would  allow  anybody  to
  1049.      read/write/format all your disks.
  1050.  
  1051.  
  1052.  
  1053. Joerg Schilling    Last change: Version 1.8.1                  16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  1061.  
  1062.  
  1063.  
  1064.      You should not  connect  old  drives  that  do  not  support
  1065.      disconnect/reconnect  to  either  the  SCSI bus that is con-
  1066.      nected to the CD-Recorder or the source disk.
  1067.  
  1068.      A Compact Disc can have no more than 99 tracks.
  1069.  
  1070.      When creating a disc with both audio and  data  tracks,  the
  1071.      data  should  be  on  track  1 otherwise you should create a
  1072.      CDplus disk which is a multi session  disk  with  the  first
  1073.      session  containing  the audio tracks and the following ses-
  1074.      sion containing the data track.
  1075.  
  1076.      Many operating systems are not able to read more than a sin-
  1077.      gle data track, or need special software to do so.
  1078.  
  1079.      More information on the SCSI command set of a HP CD-Recorder
  1080.      can be found at:
  1081.  
  1082.           http://www.hp.com/isgsupport/cdr/index.html
  1083.  
  1084.      If you have more information or  SCSI  command  manuals  for
  1085.      currently   unsupported   CD-Recorders  please  contact  the
  1086.      author.
  1087.  
  1088.      The Philips CDD 521 CD-Recorder (even in the  upgraded  ver-
  1089.      sion) has several firmware bugs. Some of them will force you
  1090.      to power cycle the device or to reboot the machine.
  1091.  
  1092.      When using ccccddddrrrreeeeccccoooorrrrdddd  with  the  broken  LLLLiiiinnnnuuuuxxxx  SSSSCCCCSSSSIIII  ggggeeeennnneeeerrrriiiicccc
  1093.      ddddrrrriiiivvvveeeerrrr....  You  should  note  that  ccccddddrrrreeeeccccoooorrrrdddd uses a hack, that
  1094.      tries to  emulate  the  functionality  of  the  scg  driver.
  1095.      Unfortunately,  the  sg  driver  on LLLLiiiinnnnuuuuxxxx has several severe
  1096.      bugs:
  1097.  
  1098.      +o     It cannot see if a SCSI command could not be  sent  at
  1099.           all.
  1100.  
  1101.      +o     It cannot get the SCSI status byte. CCCCddddrrrreeeeccccoooorrrrdddd for  that
  1102.           reason  cannot  report  failing  SCSI  commands in some
  1103.           situations.
  1104.  
  1105.      +o     It cannot get real DMA  count  of  transfer.  CCCCddddrrrreeeeccccoooorrrrdddd
  1106.           cannot tell you if there is an DMA residual count.
  1107.  
  1108.      +o     It cannot get number of  bytes  valid  in  auto  sense
  1109.           data.   CCCCddddrrrreeeeccccoooorrrrdddd cannot tell you if device transfers no
  1110.           sense data at all.
  1111.  
  1112.       +o     It  fetches  to  few  data  in  auto  request   sense
  1113.           (CCS/SCSI-2/SCSI-3 needs >= 18).
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119. Joerg Schilling    Last change: Version 1.8.1                  17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  1127.  
  1128.  
  1129.  
  1130.      The fifo percent output is computed just after  a  block  of
  1131.      data  has  been written to the CD-Recorder. For this reason,
  1132.      there will never be 100% fifo fill, while  the  fifo  is  in
  1133.      streaming mode.
  1134.  
  1135.  
  1136. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  1137.      You have 9 seconds to type ^C to abort  ccccddddrrrreeeeccccoooorrrrdddd  after  you
  1138.      see the message:
  1139.  
  1140.      Starting to write CD at speed %d in %s mode for %s session.
  1141.  
  1142.      A typical error message for a SCSI command looks like:
  1143.  
  1144.           cdrecord: I/O error. test unit ready: scsi sendcmd: no error
  1145.           CDB:  00 20 00 00 00 00
  1146.           status: 0x2 (CHECK CONDITION)
  1147.           Sense Bytes: 70 00 05 00 00 00 00 0A 00 00 00 00 25 00 00 00 00 00
  1148.           Sense Key: 0x5 Illegal Request, Segment 0
  1149.           Sense Code: 0x25 Qual 0x00 (logical unit not supported) Fru 0x0
  1150.           Sense flags: Blk 0 (not valid)
  1151.  
  1152.      The first line gives information about the transport of  the
  1153.      command.   The  text  after  the first colon gives the error
  1154.      text for the system call from the view  of  the  kernel.  It
  1155.      usually  is:   IIII////OOOO  eeeerrrrrrrroooorrrr  unless other problems happen. The
  1156.      next words contain a short description for the SCSI  command
  1157.      that fails. The rest of the line tells you if there were any
  1158.      problems for the transport of the command over the SCSI bus.
  1159.      ffffaaaattttaaaallll  eeeerrrrrrrroooorrrr means that it was not possible to transport the
  1160.      command (i.e.  no  device  present  at  the  requested  SCSI
  1161.      address).
  1162.  
  1163.      The second line prints the SCSI command descriptor block for
  1164.      the failed command.
  1165.  
  1166.      The third line gives information on  the  SCSI  status  code
  1167.      returned  by  the  command,  if the transport of the command
  1168.      succeeds. This is error information from the SCSI device.
  1169.  
  1170.      The fourth line is a hex dump  of  the  auto  request  sense
  1171.      information for the command.
  1172.  
  1173.      The fifth line is the error text for the sense key if avail-
  1174.      able,  followed  by the segment number that is only valid if
  1175.      the command was a _c_o_p_y command. If the error message is  not
  1176.      directly  related  to the current command, the text _d_e_f_e_r_r_e_d
  1177.      _e_r_r_o_r is appended.
  1178.  
  1179.      The sixth line is the error text for the sense code and  the
  1180.      sense  qualifier if available.  If the type of the device is
  1181.      known, the sense data is decoded from tables in _s_c_s_i_e_r_r_s._c .
  1182.  
  1183.  
  1184.  
  1185. Joerg Schilling    Last change: Version 1.8.1                  18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  1193.  
  1194.  
  1195.  
  1196.      The text is followed by the error value for a field replace-
  1197.      able unit.
  1198.  
  1199.      The seventh line prints the block number that is related  to
  1200.      the  failed  command  and  text for several error flags. The
  1201.      block number may not be valid.
  1202.  
  1203.      The following message is not an error:
  1204.           Track 01: Total bytes read/written: 2048/2048 (1 sectors).
  1205.           cdrecord: I/O error. flush cache: scsi sendcmd: no error
  1206.           CDB:  35 00 00 00 00 00 00 00 00 00
  1207.           status: 0x2 (CHECK CONDITION)
  1208.           Sense Bytes: F0 00 05 80 00 00 27 0A 00 00 00 00 B5 00 00 00 00 00
  1209.           Sense Key: 0x5 Illegal Request, Segment 0
  1210.           Sense Code: 0xB5 Qual 0x00 (dummy data blocks added) Fru 0x0
  1211.           Sense flags: Blk -2147483609 (valid)
  1212.  
  1213.      It simply notifies, that a track that is  smaller  than  the
  1214.      minimum size has been expanded to 300 sectors.
  1215.  
  1216. BBBBUUUUGGGGSSSS
  1217.      CCCCddddrrrreeeeccccoooorrrrdddd has even more options than llllssss.
  1218.  
  1219.      CCCCddddrrrreeeeccccoooorrrrdddd currently only warns if the input data will not fit
  1220.      on  the  disk.   If you don't abort the command you will get
  1221.      unpredictable results.
  1222.  
  1223.      There should be an option to write index numbers  for  audio
  1224.      tracks.
  1225.  
  1226.      There should be a recover option to make disks usable,  that
  1227.      have been written during a power failure.
  1228.  
  1229.  
  1230. CCCCRRRREEEEDDDDIIIITTTTSSSS
  1231.      Bill Swartz    (Bill_Swartz@twolf.com)
  1232.                     For helping me with the TEAC driver support
  1233.  
  1234.      Aaron Newsome  (aaron.d.newsome@wdc.com)
  1235.                     For letting me develop Sony  support  on  his
  1236.                     drive
  1237.  
  1238.      Eric Youngdale (eric@andante.jic.com)
  1239.                     For supplying mkisofs
  1240.  
  1241.      Gadi Oxman     (gadio@netvision.net.il)
  1242.                     For tips on the ATAPI standard
  1243.  
  1244.      Finn Arne Gangstad  (finnag@guardian.no)
  1245.                     For the first FIFO implementation.
  1246.  
  1247.      Dave Platt     (dplatt@feghoot.ml.org)
  1248.  
  1249.  
  1250.  
  1251. Joerg Schilling    Last change: Version 1.8.1                  19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. CDRECORD(1)          Schily's USER COMMANDS           CDRECORD(1)
  1259.  
  1260.  
  1261.  
  1262.                     For creating the experimental packet  writing
  1263.                     support,  the  first  implementation of CD-RW
  1264.                     blanking support, the first .wav file decoder
  1265.                     and many nice discussions on cdrecord.
  1266.  
  1267.      Chris P. Ross (cross@eng.us.uu.net)
  1268.                     For the first implementation os a  BSDI  SCSI
  1269.                     rtansport.
  1270.  
  1271.      Grant R. Guenther   (grant@torque.net)
  1272.                     For creating the first  parallel  port  tran-
  1273.                     sport implementation for Linux.
  1274.  
  1275.      Kenneth D. Merry (ken@kdm.org)
  1276.                     for  providing  the  CAM  port  for   FreeBSD
  1277.                     together       with       Michael       Smith
  1278.                     (msmith@freebsd.org)
  1279.  
  1280.  
  1281. MMMMAAAAIIIILLLLIIIINNNNGGGG LLLLIIIISSSSTTTTSSSS
  1282.      If you want to actively take  part  on  the  development  of
  1283.      cdrecord, you may join the cdwriting mailing list by sending
  1284.      mail to:
  1285.  
  1286.           other-cdwrite-request@lists.debian.org
  1287.  
  1288.      and include the  word  _s_u_b_s_c_r_i_b_e  in  the  body.   The  mail
  1289.      address of the list is:
  1290.  
  1291.           cdwrite@lists.debian.org
  1292.  
  1293.  
  1294. AAAAUUUUTTTTHHHHOOOORRRR
  1295.      Joerg Schilling
  1296.      Seestr. 110
  1297.      D-13353 Berlin
  1298.      Germany
  1299.  
  1300.      Additional information can be found on:
  1301.      http://www.fokus.gmd.de/usr/schilling/cdrecord.html
  1302.  
  1303.      Mail bugs and suggestions to:
  1304.  
  1305.      jjjjooooeeeerrrrgggg@@@@sssscccchhhhiiiillllyyyy....iiiissssddddnnnn....ccccssss....ttttuuuu----bbbbeeeerrrrlllliiiinnnn....ddddeeee or  jjjjssss@@@@ccccssss....ttttuuuu----bbbbeeeerrrrlllliiiinnnn....ddddeeee  or
  1306.      sssscccchhhhiiiilllllllliiiinnnngggg@@@@ffffooookkkkuuuussss....ggggmmmmdddd....ddddeeee
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317. Joerg Schilling    Last change: Version 1.8.1                  20
  1318.  
  1319.  
  1320.  
  1321.